package com.geek.gkpush.framework.event;

import com.geek.gkpush.framework.event.model.EventMsgDTO;
import com.geek.gkpush.framework.event.model.EventMsgRangeQueryModel;
import com.geek.gkpush.framework.event.model.EventMsgUpdateModel;

import java.util.List;

/**
 * <h1>事件消息持久化接口。</h1><br/>
 *
 * <h1><br/><a href="https://u.geekbang.org/subject/arch3/100614201">Java 业务架构实战营：https://u.geekbang.org/subject/arch3/100614201</a></h1><br/><h1><a href="https://gitee.com/ylimhhmily/BizArchPracticeCamp">Java 业务架构实战营代码地址：https://gitee.com/ylimhhmily/BizArchPracticeCamp</a></h1><br/><h1><a href="https://u.geekbang.org/subject/java4th/1001148?source=app_share">高级 Java 工程体系课 2023 版：https://u.geekbang.org/subject/java4th/1001148?source=app_share</a></h1><br/><h1><a href="https://time.geekbang.org/column/intro/100312101?tab=catalog">Dubbo 源码剖析与实战：https://time.geekbang.org/column/intro/100312101?tab=catalog</a></h1>
 *
 * @author hmilyylimh
 * ^_^
 * @version 0.0.1
 * ^_^
 * @date 2023/10/3 08:14
 */
public interface EventMsgPersistFacade {

    /**
     * <h2>保存事件消息。</h2>
     *
     * @param: reqMsg
     */
    void saveEventMsg(EventMsgDTO reqMsg);

    /**
     * <h2>批量保存事件消息。</h2>
     *
     * @param: reqMsgList
     */
    void batchSaveEventMsg(List<EventMsgDTO> reqMsgList);

    /**
     * <h2>更新事件消息，最好根据 id 分布式唯一字段进行更新，还有注意里面携带了 srcPushStatus 源状态，更新的时候需要带上源状态。</h2>
     *
     * @param: model
     * @return: int
     */
    int updatePushStatusByCondition(EventMsgUpdateModel model);

    /**
     * <h2>根据 id 查找事件对象。</h2>
     *
     * @param: id
     * @return: com.geek.gkpush.framework.event.model.EventMsgDTO
     */
    EventMsgDTO queryObjectById(String id);

    /**
     * <h2>根据模型对象查询符合条件的数据，并且做更新逻辑处理。</h2>
     *
     * @param: rangeModel
     * @return: void
     */
    void rangeUpdateList2Succ(EventMsgRangeQueryModel rangeModel);
}